[PATCH] perf docs: Fix perf-check manual page built with asciidoctor
authorBen Hutchings <benh@debian.org>
Sun, 23 Mar 2025 20:04:02 +0000 (21:04 +0100)
committerSalvatore Bonaccorso <carnil@debian.org>
Sun, 30 Mar 2025 14:50:14 +0000 (16:50 +0200)
commitf981f160abed8fd40093263612006eab403d633b
tree77e5c6e34f3b58ba945195687a4d6cef1c39d358
parentc74d3376719ebfce58823909abc0ea68fb2fb7b9
[PATCH] perf docs: Fix perf-check manual page built with asciidoctor

Forwarded: https://lore.kernel.org/linux-perf-users/Z-BxCE8WrcRmR_5f@decadent.org.uk/

asciidoctor is more picky than asciidoc about the length of heading
underlines, and currently mis-parses perf-check.txt:

  ASCIIDOC perf-check.1
asciidoctor: ERROR: perf-check.txt: line 1: non-conforming manpage title
asciidoctor: ERROR: perf-check.txt: line 1: name section expected
asciidoctor: WARNING: perf-check.txt: line 2: unterminated example block
asciidoctor: WARNING: perf-check.txt: line 5: unterminated listing block

Fix the length of the title underline so it works properly.

Fixes: 98ad0b77323c ("perf check: Introduce 'check' subcommand")
Signed-off-by: Ben Hutchings <benh@debian.org>
Gbp-Pq: Topic bugfix/all
Gbp-Pq: Name perf-docs-Fix-perf-check-manual-page-built-with-asci.patch
tools/perf/Documentation/perf-check.txt